LISTRS -- Directory/Program List Makers With Action Options Copyright (c) 1995 by David M. Wincelberg Table of Contents I. Introduction ............................................. 1 II. How to Use ............................................... 2 Appendices: A. Command Line Switches .................................... 3 B. Trouble-shooting ......................................... 4 C. Other FileJockey Software Products ....................... 4 D. License Agreement ........................................ 5 I. Introduction Thank you for trying LISTRS. LISTRS is a pair of programs to help you find directories and program files. In addition, these programs provide you with several options for a selected directory or program. The first one, DIRLIST, presents a directory list that is more accurate than that produced by "dir *." since directories may have an extension and other files might not. Options for a selected directory include showing a list of its files, changing to it and removing it from your computer if it is empty. The other program, PROGLIST, shows the current directory's program files (those with extensions EXE, COM or BAT) in one listing to help you find the name of the program file to run. This is helpful since, when you have not used a DOS program in a while, you might not remember what extension the program file has. Its options include type & run the program, type & wait and view or edit .BAT files. The first option places the selected program on the command line and "presses" while the second option allows you to add parameters or switches before running the program. Neither of these options takes any memory away from your program. (The program name is stored in a reserved area of memory called the keyboard buffer and PROGLIST is cleared from memory before DOS reads this name.) Both programs correctly sort numbers within filenames. For example, FILE2 would appear before FILE10 if you have files by these names in a directory. In contrast, DOS and every other program I am aware of, would place FILE10 before FILE2 since "1" is less than "2". These programs are safe to run on a Pentium processor since, as far as I am able to determine, they do not perform any floating point divisions of large numbers. If you decide to keep this program after 30 days, you are required to pay the $10 license and registration fee in order to use this program legally, receive technical support and be notified of updates and bug fixes. (FileJockey Software does not release products with known bugs.) Otherwise, you may not keep the individual files on your PC but you may keep the .ZIP file. A registration form containing my postal address is provided for you in the file LISTRS.REG. Send comments, suggestions and problem reports to me at 71573,1023 by CompuServe (not Internet) e-mail or at my postal address. I plan to read each one, but, if I receive a large amount of mail, I may not be able to reply to each letter. You may share this program with others. Please tell the recipient(s) that the amount you are charging, if any, does not include the license and registration fee. This product is not available directly from me. It is only available from bulletin boards, friends, shareware distributors, etc. LISTRS requires DOS 2.1 or higher. II. How to Use A. DIRLIST To generate an accurate list of directories in the current directory, enter: DIRLIST Unlike using "dir *.", DIRLIST does not include files that have no extension and does include directories with extensions. If you just want this list to be typed on your screen, enter: DIRLIST /T You may also use the /W and /P switches for a wide display and pausing between pages, respectively. If you don't use command line switches, DIRLIST will ask you to select a directory from the list and then presents you with the Directory Options screen. The option buttons on this screen are: change To, Show files, Remove, Cancel, and review List. You may select an option using the mouse, using the arrow keys to highlight a choice and pressing , or by pressing the capitalized letter of the desired button. Also, pressing the key is equivalent to selecting Cancel. After reviewing the sorted list of files generated by selecting Show files, press or select any file to return to the Directory Options screen. No use is made of the selected file. If you choose Remove and the directory is not empty, you will receive a warning message and will be returned to the Directory Options screen after you press or click the mouse to select the Continue button. Finally, you may specify a directory other than the current one by typing its name on the command line. This name may appear before, after or in between switches. B. PROGLIST To generate a list of programs (those with extensions EXE, COM or BAT) in the current directory, enter: PROGLIST If you just want this list to be typed on your screen, enter: PROGLIST /T You may also use the /W and /P switches for a wide display and pausing between pages, respectively. If you don't use command line switches, PROGLIST will ask you to select a program from the list and then presents you with the Program Options screen. The option buttons on this screen are: type & Run, review List, type & Wait, Cancel, View file, and Edit file. The last two options only appear if the selected program has extension BAT. You may select an option using the mouse, using the arrow keys to highlight a choice and pressing , or by pressing the capitalized letter of the desired button. Also, pressing the key is equivalent to selecting Cancel. The options including the word "type" cause the program to place the selected program name on the command line. Choose type & Run if you want this program to run immediately and choose type & Wait if you want to add parameters or switches after the program name. The view and edit options invoke a full screen viewer/editor (that does not respond to mouse commands). To exit this editor, press and answer "Y" (or "y") to the question "Are You Sure (Y/N)?". In addition to the normal cursor positioning commands, this editor responds to the following: -F Find a word or phrase -L Load in another file In edit mode, the editor also responds to , , , as well as the following: -D Delete the current row -R Rename the file -S Save the file If instead of -S you press , you will be given a chance to save the file. If you do so in this manner, the program will make a backup file with extension BAK. Appendices A. Command Line Switches Entering DIRLIST /? produces the following summary of command line switches: Lists Subdirectories With Action Options DIRLIST [directory] [switches] /T Type names directly on the screen /P Pause after each screen of information /W Use wide display -- 5 names per line /P and /W only apply when /T is used The directory name may be a full or partial name. Using /T results in the program typing the directory list on the screen instead of presenting a scrollable pick list and options for the selected directory. Entering PROGLIST /? produces a similar summary: Lists Programs With Action Options PROGLIST [switches] /T Type names directly on the screen /P Pause after each screen of information /W Use wide display -- 5 names per line /P and /W only apply when /T is used B. Trouble-shooting Cannot remove directory: DIRLIST does not delete directories that contain files or directories other than "." and "..". However, tools such as DOS DELTREE do remove non-empty directories. Out of memory: If possible, stop another program and try DIRLIST or PROGLIST again. Alternatively, you may wish to use a memory management package to move some programs to high memory. (See your DOS manual for further details.) File/directory read or write errors: Try a disk repair utility to fix your disk. There are now such utilities in recent versions of DOS. For serious problems, you may wish to consider a third party product. C. Other FileJockey Software Products Following is a list of current FileJockey Software products. All of the compressed files for these products have extension ZIP. In parentheses after the descriptions are the locations where the programs may be found on CompuServe and the registration/license fees. 1. Cyberspace/CompuServe Tools CFWRAP 1.1 -- Word Wrapping Tuned for BBS Capture Files: Prepares BBS capture files for editing by removing page pause lines ("Press for more !", etc.) and word-wrapping various types of paragraphs (including each line starting with ">>" and indented paragraphs). Many page pause lines are in a user- changeable .INI file. Version 1.1 improvements include multi-BBS support, better word wrapping, dialog boxes and mouse support. Pentium safe. (GO PCCOM, Library 2, $15) FRMDSK 1.0 -- Enters Text From Disk With Line Preview & Edit: Use FRMDSK when a BBS requires you to type in lines instead of allowing you to upload a file. It copies lines from a file to your BBS software (or other program) after giving you options. These options include edit line, finish file, wait, cancel, next/previous line and another file. Works only with DOS text programs that read the keyboard in the standard way. Pentium safe 66K TSR. (GO PCCOM, Library 2, $15) 2. Programmer Tool PROGCR 1.0 -- Prepares Programs for Copyrighting: Protects the privacy of your C/C++ or PASCAL source code copyright deposit by removing comments after each file's header (which should primarily consist of your copyright notice) from copies of the original files. Also, copies words displayed by standard or user-specified print commands to a file for spell checking. Pentium safe. (GO PCPROG, Library 6, $10) D. License Agreement This is a legal agreement between you ("Licensee") and FileJockey Software ("Licensor"). Licensor owns all worldwide rights, title, copyright and other interests in and to the computer program identified as LISTRS 1.0 ("Software"). By using the Software, you are agreeing to be bound by the following terms: 1. Licensor grants to Licensee the non-exclusive and non- assignable right to use the Software for a period of 30 days without paying a fee to Licensor. After 30 days, Licensee may continue this right by paying $10 to Licensor. 2. Licensee may distribute copies of the Software and related files to others provided Licensee informs the recipients that the Software is subject to a license agreement and that the fee you charge, if any, does not include the license fee. 3. Licensor hereby alerts Licensee that the Software and accompanying documentation are provided "AS IS" without warranty of any kind. Licensor assumes all risks involving use of the Software and its results and performance. 4. Licensee hereby acknowledges that Licensor bears no responsibility or liability which may arise or result from Licensee's use of the Software. Licensee hereby waives and releases Licensor from any and all claims for damages, losses and costs therefrom. In no event shall Licensor's liability for any damages ever exceed the price paid for license and registration, regardless of the form of the claim. 5. This license agreement shall be construed and enforced in accordance with the laws of the State of California. This agreement may not be modified except by written instrument signed by both parties. If any provisions of this agreement are found to be invalid or unenforceable by the operation of the law, then invalidity or unenforceability of such provision(s) shall not affect the validity or enforceability of the other provisions of this agreement. Any dispute arising from this agreement shall be submitted to California courts located in Los Angeles County, and Licensee hereby submits to the jurisdiction of such courts. All (registered) trademarks and (registered) service marks are properties of their respective companies.